home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1993…ch: Other People's Memory / ADC Developer CD (1993-03) (''Other People's Memory'')_iso / Dev.CD Mar 93.iso / Development Platforms / Apple II / Essentials / Technical.Notes / IIGS / TN.IIGS.066 < prev    next >
Encoding:
Text File  |  1992-07-15  |  5.7 KB  |  116 lines  |  [TEXT/GEOL]
  1. Apple II
  2. Technical Notes
  3. _____________________________________________________________________________
  4.                                                   Developer Technical Support
  5. Apple IIgs
  6. #66: ExpressLoad Philosophy
  7.  
  8. Revised by: Matt Deatherage                                          May 1992
  9. Written by: Matt Deatherage                                    September 1989
  10.  
  11. This Technical Note discusses the ExpressLoad feature and how it relates to
  12. the standard Loader and your application.
  13.  
  14. CHANGES SINCE SEPTEMBER 1990:  Clarified some changes now that ExpressLoad and
  15. the System Loader are combined to be "Loader 4.0" in System Software 6.0.
  16. Completely removed the note about not calling Close(0) since it's not
  17. relevant.
  18. _____________________________________________________________________________
  19.  
  20.  
  21.  
  22. SPEEDY THE LOADER HELPER
  23.  
  24. ExpressLoad is a GS/OS feature which is usually present with System Software
  25. 5.0 (if the ExpressLoad file is present and there's more than 512K of RAM),
  26. and always on System Software 5.0.4 and later.  In fact, ExpressLoad is no
  27. longer a separate file in System Software 6.0; it's included in the System
  28. Loader version 4.0.  Even though ExpressLoad is part of the Loader, we refer
  29. to its functionality separately to distinguish how the Loader takes special
  30. advantage of "expressed" files.
  31.  
  32. ExpressLoad operates on Object Module Format (OMF) files which have been
  33. "expressed," using either the APW tool Express (or it's MPW counterpart,
  34. ExpressIIgs) or created that way by a linker.  Expressed files contain a
  35. dynamic data segment named either ExpressLoad or ~ExpressLoad at the beginning
  36. of the file. (Current versions of Express and ExpressIIgs create ~ExpressLoad
  37. segments, which is the preferred naming convention; older versions created
  38. ExpressLoad segments, and should be re-Expressed for future compatibility.)
  39. This segment contains information which allows the Loader to load these files
  40. more quickly, including such things as file offsets to segment headers,
  41. mappings of old segment numbers to new segment numbers (these files may have
  42. their segments rearranged for optimal performance), and file offsets to
  43. relocation dictionaries.
  44.  
  45.  
  46. TWO LOADER COMPONENTS, TWO MISSIONS, ONE FUNCTION
  47.  
  48. The System Loader's function is to interpret OMF.  It takes files on disk (or
  49. in memory) and transforms them from load files into relocated 65816 code.  It
  50. does this very well, but in a very straightforward way.  For example, when the
  51. System Loader sees the instruction to right-shift a value n times, it loads a
  52. register with the value and performs a right-shift n times.
  53.  
  54. ExpressLoad has a different mission.  It relies upon the rest of the System
  55. Loader to handle OMF in a straightforward fashion so it can concentrate upon
  56. handling the most common OMF cases in the fastest possible way.  For example,
  57. when asked for a specific segment in a load file, the System Loader "walks"
  58. the OMF until it finds the desired segment.  ExpressLoad, however, goes
  59. directly to the desired segment since an Expressed file contains precalculated
  60. offsets to each segment in the ExpressLoad segment.
  61.  
  62. Since ExpressLoad focuses on the common things performed by the majority of
  63. applications, it may not support those applications which rely upon certain
  64. features of OMF or the System Loader.  In these cases, the System Loader loads
  65. the file as is expected.
  66.  
  67. ExpressLoad always gets first crack at loading a file, and if it is an
  68. Expressed file that ExpressLoad can handle, it loads it.  If the file is not
  69. an Expressed file, the regular System Loader loads it instead.  ExpressLoad
  70. also gets first shot at other loader calls.
  71.  
  72. Because an Expressed file is a standard OMF file with an additional segment,
  73. Expressed files are almost fully compatible with the System Loader (although
  74. it cannot load them any faster than before).  Refer the following section for
  75. potential problems.
  76.  
  77.  
  78. WORKING WITH EXPRESSLOAD
  79.  
  80. As ExpressLoad is intimate in its relationship with the System Loader, most
  81. applications work seamlessly with it; however, there are some potential
  82. problems about which you should be aware.
  83.  
  84.    o   Don't mix Expressed files and normal OMF files with the same user ID.
  85.        For example, if your application uses InitialLoad with a separate
  86.        file, make sure that if it and your main application share the same
  87.        user ID that they are both either Expressed files or normal OMF files.
  88.  
  89.    o   Don't use a user ID of zero.  In the past, use of zero told the System
  90.        Loader to use the current user ID; however, now both the System Loader
  91.        and ExpressLoad have a current user ID.  Be specific about user IDs
  92.        when loading.  This is fixed in 6.0, but is still a good thing to
  93.        avoid for compatibility with System Software 5.0 through 5.0.4.
  94.  
  95.    o   Avoid loading and unloading segments by number.  Since Expressed files
  96.        may have their segments rearranged, if an Expressed file is loaded by
  97.        the System Loader, references to segments by number may be incorrect.
  98.  
  99.    o   Avoid using GetLoadSegInfo before System Software 6.0.  This call
  100.        returns System Loader data structures which are not supported by
  101.        ExpressLoad previous to 6.0.  In System Software 6.0 and later, the
  102.        combined Loaders return correct information for GetLoadSegInfo
  103.        regardless of whether the load file is expressed or not.
  104.  
  105.    o   Don't try to load segments in files which have not been loaded with
  106.        the call InitialLoad.  This process was never a very good idea, and it
  107.        is now apt to cause problems.
  108.  
  109.    o   Don't have segments that link to other files.  ExpressLoad does not
  110.        support this type of link.
  111.  
  112. Further Reference
  113. _____________________________________________________________________________
  114.  
  115.    o   GS/OS Reference
  116.